home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / lf341.arc / LF.DOC < prev   
Encoding:
Text File  |  1986-07-29  |  7.3 KB  |  209 lines
  1. LF - Directory lister for humans.
  2.         
  3.         by: Windspear Software Systems
  4.             P.O. Box 2297
  5.             Iowa City, Iowa  52244
  6.  
  7. Copyright 1985, 1986 by Windspear Software Systems 
  8.  
  9. All commercial rights reserved. May be freely copied and used for 
  10. private use only -- not for resale. May be distributed on public access 
  11. remote computer bulletin boards.
  12.  
  13. LF is supplied as a user supported package. Private individuals are 
  14. encouraged to copy and share this package with others. If you are using 
  15. this program and finding it of value, your contribution ($10 suggested) 
  16. will be appreciated. Regardless of whether you make a contribution, you 
  17. are encouraged to copy and share this program.
  18.  
  19. Please send any comments/problems to Windspear Software Systems. If you 
  20. want a response and are a contributing user also include a self 
  21. addressed stamped envelope.
  22.  
  23. Please make the user supported software concept work by sending in your 
  24. $10 contribution.
  25.  
  26.                                            Jordan Archer
  27.                                            Windspear Software Systems
  28.                                            P.O. Box 2297
  29.                                            Iowa City, Iowa  52244
  30.  
  31. LF - Directory lister for humans.
  32.  
  33.  
  34. Usage: LF [pattern] ["format"] {prefix[n]option}
  35.  
  36. Pattern:
  37.  
  38.     [!][drive:][path][file] { [!][file] }
  39.  
  40.     Drive: a - z.
  41.     Path: Any PC-DOS path ending in a '\'.
  42.     File: Normal file name with wild cards.
  43.  
  44.     The '!' means exclude all the files from the previous files list
  45.     taht match the file wild card. This is done in a left to right 
  46.     manner. For example:
  47.  
  48.         lf !*.bat               Means list all files that are not .bat
  49.  
  50.         lf *.b* !*.?a? *.bat    Is processed as:
  51.                                     1 ) List all *.b* files.
  52.                                     2 ) From that list remove all *.?a? files.
  53.                                     3 ) From that list add all *.bat files.
  54.  
  55. Prefixes:
  56.  
  57.    '-' or '/' if not disabled.
  58.  
  59. Format:  '' or ""
  60.  
  61.     LF can be used to generate batch files with a combination of the fromat
  62.     strings and redirection. When a format string is used all other options
  63.     are turned off allowing easy generation of batch files. For each file 
  64.     normally ouput by LF the format string is scanned and the substitution
  65.     commands are replaced with the proper values.  Valid substitution
  66.     commands are:
  67.  
  68.         *f - File name. Not including the extension and period.
  69.         *e - File extension. Not including the period.
  70.         ** - For a '*' character.
  71.         *n - New line. Same a a carriage return.
  72.         *t - Tab character.
  73.         *' - The ' character.
  74.         *" - The " character.
  75.  
  76.     The command:
  77.  
  78.         lf *.c "copy *f.*e *f.old*n"
  79.  
  80.     would cause the following output:
  81.  
  82.         copy lf.c lf.old
  83.         copy lflib.c lflib.old
  84.         copy lib.c lib.old
  85.  
  86.     If the above LF command were redirected to a file, it could be used
  87.     as a batch file to copy the '*.c' files.
  88.     ( i.e. 'lf *.c "copy *f.*e *f.old*n" >x.bat' )
  89.  
  90.  
  91. LF - Directory lister for humans.
  92.  
  93.  
  94. Format (cont):  '' or ""
  95.  
  96.     Warning:
  97.         If you use a format string and want each file line on a separate
  98.         line you must include '*n' as part of your string.
  99.  
  100. Options:
  101.  
  102.     a - File attribute pattern match. (off)
  103.         The '-a' option controls if the attributes are listed and the
  104.         pattern of attributes that the listed files must match.  The
  105.         optional attribute patterns are 'a' archive, 'r' read only,
  106.         'h' hidden and 's' system. Any pattern character can be prefixed
  107.         with a '!' for exclusion of that attribute. For examples:
  108.  
  109.             -ah     - Lists files with the hidden attribute.
  110.  
  111.             -a!a    - Lists files without the archive attribute.
  112.  
  113.             -ar!h!s - Lists files that are read only but not hidden or system.
  114.  
  115.             -a      - Sets no limits on the attributes so lists all files,
  116.                       including hidden and system.
  117.  
  118.             -aarhs  - Same as '-a'.
  119.  
  120.         Note: The 'a' attribute means the file's archive bit is
  121.               cleared (has been archived).
  122.  
  123.     c - Combine files and directories. (off)
  124.         When this is on 'LF' is similar to other file listers,
  125.         with directories and files mixed.
  126.  
  127.     d - List directories. (on)
  128.         By using the '-nd' option you will get only the files.
  129.  
  130.     f - List files. (on)
  131.         By using the '-nf' option you will get only the directories.
  132.  
  133.     h - Controls printing of headers.
  134.         1 - Banner header. (on)
  135.         2 - Volume label and path header. (on)
  136.         3 - File type labels. (on)
  137.         no options controls all three at once.
  138.  
  139.  
  140. LF - Directory lister for humans.
  141.  
  142.  
  143. Options (cont):
  144.  
  145.     l - List date/time stamps. (off)
  146.  
  147.     s - Sizes of files. (off)
  148.  
  149.     sc - Size of files and directory sizes in clusters. (off)
  150.         Optional cluster size. (i.e. '-sc512' gives size for clusters
  151.         of 512 bytes). This gives the disk space taken by each of
  152.         the subdirectories.
  153.  
  154.     t - List total file space and free disk space. (on)
  155.  
  156.     p - Pause, printer formfeed, file '^Z' terminate. (on)
  157.         The effect of the '-p' option varies depending on where the
  158.         output of the LF command is directed.
  159.         When the output is directed to the screen (the normal case),
  160.         '-p' causes LF to pause every 25 lines.
  161.         When output is redirected to the printer, ( i.e. 'LF *.c >PRN' )
  162.         '-p' causes a formfeed at the end of the output.
  163.         When output is redirected to a file, the '-p' option 
  164.         causes LF to write an end-of-file marker '^Z', and '-np' (the default)
  165.         causes LF to fill the last file record with zeroes.
  166.  
  167.     o,r - Order/Reverse for sorting files. ('-on')
  168.         r - Reverse order sort. Yes you can use '-rr' as '-o'.
  169.             s - Size sort.
  170.             n - Name sort. This is the default for '-o'
  171.             d,t,l - Date/time sort.
  172.             e,x - Extension sort.
  173.             u - Unsorted. Order is the same as the DIR command.
  174.                 Same as '-no' no order, '-nr' is a reverse unsorted.
  175.  
  176.     z - Everything option. (off)
  177.         This controls the following options all at once:
  178.             a, l, s, t.        
  179.  
  180.     1,2,3,4,5,6,7,8 - Set maxium number of columns.  (8)
  181.  
  182.     '-', '/' - Set/Disable the option prefix character(s). (on)
  183.         This allows you to disable one or both of the options prefix
  184.         characters, which are '-' and '/'. (e.g., '-n-' disables the
  185.         '-' prefix so that a following '-no' is considered a file name
  186.         instead of an option.)
  187.  
  188.     All options can be prefixed with a 'n' to turn them off.
  189.  
  190.  
  191. LF - Directory lister for humans.
  192.  
  193.  
  194. Environment variable:
  195.  
  196.     The environment varible 'LF' is searched for options
  197.     before the command line. By setting 'LF' you can set
  198.     your own default setings for all options.  For example typing
  199.  
  200.         SET LF= -NH -T
  201.  
  202.     at the DOS prompt will set the default value for the header to off
  203.     and the default for disk space totals to on. 
  204.  
  205.                 Copyright 1985, 1986,
  206.                 Windspear Software Systems
  207.                 P.O. Box 2297
  208.                 Iowa City, Iowa  52244
  209.